Skip to content

Conversation

@joshua-koehler
Copy link

@joshua-koehler joshua-koehler commented Nov 17, 2025

Background

Local evaluation already supports evaluating the legacy runtime rule, which was simple exact key-value matching.

This pr

Support complex runtime rules in local-evaluation using jsonLogic.

QA'd local and remote eval ✅

https://github.com/mixpanel/sdk-integration-testing/commit/fe6d0968da0d4f30ce482abf46906d82bf7cc373

Example of what they look like in the UI

image

Copy link

@msiebert msiebert left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Member

@tdumitrescu tdumitrescu left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the thorough test cases. Mostly just some nitpicks on my end!

} else {
return Object.fromEntries(
Object.entries(obj).map(([k, v]) => [
k.toLowerCase(),
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This appears to be the only difference between this util and lowercaseLeafNodes - can we consolidate into a single implementation? maybe something like lowercaseObjectEntries({lowercaseKeys: true})

"dependencies": {
"https-proxy-agent": "7.0.6"
"https-proxy-agent": "7.0.6",
"json-logic-js": "^2.0.5"
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

pin non-dev deps

Suggested change
"json-logic-js": "^2.0.5"
"json-logic-js": "2.0.5"

const otherFlag = createTestFlag({ flagKey: "other_flag" });
mockFlagDefinitionsResponse([otherFlag]);
await provider.startPollingForDefinitions();
await createFlagAndLoadItIntoSDK({ flagKey: "other_flag" }, provider);
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks for this cleanup

await createFlagAndLoadItIntoSDK({ runtimeEvaluationRule }, provider);

const context = userContextWithRuntimeParameters({
plan: randomString(),
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
plan: randomString(),
plan: randomString() + "x",

(will just ensure that regardless of the implementation of randomString() you'll never get plan: "Premium")

});

it("should return fallback when runtime rule is invalid", async () => {
const runtimeEvaluationRule = { "=oops=": [{ var: "plan" }, "Premium"] };
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Might be worth adding debug logging for this case? (at least when the rule is loaded over the network, probably too noisy to do it on every check)

});

const result = provider.getVariant(FLAG_KEY, FALLBACK, context);
expect(result.variant_value).not.toBe(FALLBACK_NAME);
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we look for a specific value here rather than just "not the fallback"? Since that could pass the test for weird failure cases like if variant_value is unexpectedly null

it("should return fallback when runtime evaluation not satisfied", async () => {
const runtimeEval = { plan: "premium", region: "US" };
const flag = createTestFlag({ runtimeEvaluation: runtimeEval });
it("should return variant when runtime evaluation rule case-insensitively satisfied", async () => {
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Logically this test case isn't any different than the one on L318 is it?

await createFlagAndLoadItIntoSDK({ runtimeEvaluationRule }, provider);

const context = userContextWithRuntimeParameters({
name: "d",
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

might be worth adding a test case where this value is a substring of one of the array values e.g. name: "all"

expect(result.variant_value).toBe(FALLBACK_NAME);
});

it("should return variant when runtime evaluation with and operator satisfied", async () => {
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

a little easier to parse?

Suggested change
it("should return variant when runtime evaluation with and operator satisfied", async () => {
it("should return variant when runtime evaluation with AND operator satisfied", async () => {

mockFlagDefinitionsResponse([flag]);
await provider.startPollingForDefinitions();
const context = userContextWithRuntimeParameters({
plan: "premium",
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Apologies if I missed it, but let's make sure to have a test case that specifies the behavior when the case of the key is mismatched e.g. {PLAN: "premium"}

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants